home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / Xt / XtAppInitialize.z / XtAppInitialize
Text File  |  1998-10-30  |  7KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXttttAAAAppppppppIIIInnnniiiittttiiiiaaaalllliiiizzzzeeee((((3333XXXXtttt))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333))))XXXXttttAAAAppppppppIIIInnnniiiittttiiiiaaaalllliiiizzzzeeee((((3333XXXXtttt))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XtAppInitialize, XtVaAppInitialize - initialize, open, or
  10.           close a display
  11.  
  12.      SSSSYYYYNNNNTTTTAAAAXXXX
  13.           Widget XtAppInitialize(_a_p_p__c_o_n_t_e_x_t__r_e_t_u_r_n,
  14.           _a_p_p_l_i_c_a_t_i_o_n__c_l_a_s_s, _o_p_t_i_o_n_s, _n_u_m__o_p_t_i_o_n_s, _a_r_g_c__i_n__o_u_t,
  15.           _a_r_g_v__i_n__o_u_t, _f_a_l_l_b_a_c_k__r_e_s_o_u_r_c_e_s, _a_r_g_s, _n_u_m__a_r_g_s)
  16.                 XtAppContext _a_p_p__c_o_n_t_e_x_t__r_e_t_u_r_n;
  17.                 String _a_p_p_l_i_c_a_t_i_o_n__c_l_a_s_s;
  18.                 XrmOptionDescRec* _o_p_t_i_o_n_s;
  19.                 Cardinal _n_u_m__o_p_t_i_o_n_s;
  20.                 int* _a_r_g_c__i_n__o_u_t;
  21.                 String* _a_r_g_v__i_n__o_u_t;
  22.                 String* _f_a_l_l_b_a_c_k__r_e_s_o_u_r_c_e_s;
  23.                 ArgList _a_r_g_s;
  24.                 Cardinal _n_u_m__a_r_g_s;
  25.  
  26.           Widget XtVaAppInitialize(_a_p_p__c_o_n_t_e_x_t__r_e_t_u_r_n,
  27.           _a_p_p_l_i_c_a_t_i_o_n__c_l_a_s_s, _o_p_t_i_o_n_s, _n_u_m__o_p_t_i_o_n_s, _a_r_g_c__i_n__o_u_t,
  28.           _a_r_g_v__i_n__o_u_t, _f_a_l_l_b_a_c_k__r_e_s_o_u_r_c_e_s, ...)
  29.                 XtAppContext _a_p_p__c_o_n_t_e_x_t__r_e_t_u_r_n;
  30.                 String _a_p_p_l_i_c_a_t_i_o_n__c_l_a_s_s;
  31.                 XrmOptionDescRec* _o_p_t_i_o_n_s;
  32.                 Cardinal _n_u_m__o_p_t_i_o_n_s;
  33.                 int* _a_r_g_c__i_n__o_u_t;
  34.                 String* _a_r_g_v__i_n__o_u_t;
  35.                 String* _f_a_l_l_b_a_c_k__r_e_s_o_u_r_c_e_s;
  36.  
  37.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  38.           _a_p_p__c_o_n_t_e_x_t__r_e_t_u_r_n
  39.                     Specifies the application context.
  40.  
  41.           _a_p_p_l_i_c_a_t_i_o_n__c_l_a_s_s
  42.                     Specifies the class name of this application,
  43.                     which usually is the generic name for all
  44.                     instances of this application.
  45.  
  46.           _o_p_t_i_o_n_s   Specifies how to parse the command line for any
  47.                     application-specific resources.  The options
  48.                     argument is passed as a parameter to
  49.                     _X_r_m_P_a_r_s_e_C_o_m_m_a_n_d.  For further information, see
  50.                     _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e.
  51.  
  52.           _n_u_m__o_p_t_i_o_n_s
  53.                     Specifies the number of entries in the options
  54.                     list.
  55.  
  56.           _a_r_g_c__i_n__o_u_t
  57.                     Specifies a pointer to the number of command line
  58.                     parameters.
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXttttAAAAppppppppIIIInnnniiiittttiiiiaaaalllliiiizzzzeeee((((3333XXXXtttt))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333))))XXXXttttAAAAppppppppIIIInnnniiiittttiiiiaaaalllliiiizzzzeeee((((3333XXXXtttt))))
  71.  
  72.  
  73.  
  74.           _a_r_g_v__i_n__o_u_t
  75.                     Specifies the command line parameters.
  76.  
  77.           _f_a_l_l_b_a_c_k__r_e_s_o_u_r_c_e_s
  78.                     Specifies resource valus to be used if the
  79.                     application class resource file cannot be opened
  80.                     or read, or NULL.
  81.  
  82.           _a_r_g_s      Specifies the argument list to override any other
  83.                     resource specification for the created shell
  84.                     widget.
  85.  
  86.           _n_u_m__a_r_g_s  Specifies the number of entries in the argument
  87.                     list.
  88.  
  89.           ...       Specifies the variable argument list to override
  90.                     any other resource specification for the created
  91.                     shell widget.
  92.  
  93.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  94.           The _X_t_A_p_p_I_n_i_t_i_a_l_i_z_e function calls _X_t_T_o_o_l_k_i_t_I_n_i_t_i_a_l_i_z_e
  95.           followed by _X_t_C_r_e_a_t_e_A_p_p_l_i_c_a_t_i_o_n_C_o_n_t_e_x_t, then calls
  96.           _X_t_O_p_e_n_D_i_s_p_l_a_y with _d_i_s_p_l_a_y__s_t_r_i_n_g NULL and _a_p_p_l_i_c_a_t_i_o_n__n_a_m_e
  97.           NULL, and finally calls _X_t_A_p_p_C_r_e_a_t_e_S_h_e_l_l with _a_p_p_c_a_t_i_o_n__n_a_m_e
  98.           NULL, _w_i_d_g_e_t__c_l_a_s_s _a_p_p_l_i_c_a_t_i_o_n_S_h_e_l_l_W_i_d_g_e_t_C_l_a_s_s, and the
  99.           specified _a_r_g_s and _n_u_m__a_r_g_s and returns the created shell.
  100.           The modified _a_r_g_c and _a_r_g_v returned by _X_t_D_i_s_p_l_a_y_I_n_i_t_i_a_l_i_z_e
  101.           are returned in _a_r_g_c__i_n__o_u_t and _a_r_g_v__i_n__o_u_t. If
  102.           _a_p_p__c_o_n_t_e_x_t__r_e_t_u_r_n is not NULL, the created application
  103.           context is also returned. If the display specified by the
  104.           command line cannot be opened, an error message is issued
  105.           and _X_t_A_p_p_I_n_i_t_i_a_l_i_z_e terminates the application. If
  106.           _f_a_l_l_b_a_c_k__r_e_s_o_u_r_c_e_s is non-NULL, _X_t_A_p_p_S_e_t_F_a_l_l_b_a_c_k_R_e_s_o_u_r_c_e_s is
  107.           called with the value prior to calling _X_t_O_p_e_n_D_i_s_p_l_a_y.
  108.  
  109.           XtAppInitialize and XtVaAppInitialize have been superceded
  110.           by _X_t_O_p_e_n_A_p_p_l_i_c_a_t_i_o_n and _X_t_V_a_O_p_e_n_A_p_p_l_i_c_a_t_i_o_n respectively.
  111.  
  112.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  113.           XtOpenApplication(3Xt), XtVaOpenApplication(3Xt)
  114.           _X _T_o_o_l_k_i_t _I_n_t_r_i_n_s_i_c_s - _C _L_a_n_g_u_a_g_e _I_n_t_e_r_f_a_c_e
  115.           _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.